home *** CD-ROM | disk | FTP | other *** search
/ Virtual Reality StarterKit / Virtual Reality StarterKit.iso / swt / vista / copyfile.swt / FRACTAL.TXT < prev    next >
Encoding:
Text File  |  1993-10-12  |  9.6 KB  |  242 lines
  1.  
  2.  
  3.     ------------------------------------------------------------------
  4.                 FRACTAL.EXE
  5.     ------------------------------------------------------------------
  6.  
  7.     FRACTAL.EXE can generate three different types of fractals: 
  8.     Mandelbrot, Julia, and Lyapunov.  FRACTAL.EXE is not meant as
  9.     general fractal exploration devices.  It was written as a means
  10.     of generating landscape for use with VistaPro. You can control
  11.     several of the parameters of the fractals.  After saving them
  12.     they can be further manipulated by VistaPro.
  13.  
  14.     All three types of fractals are mathematical objects.  They have
  15.     infinite complexity (although the calculating precision of
  16.     computers limits the amount of complexity that can be rendered)
  17.     and can make for interesting and unusual landscapes.  These
  18.     fractal landscapes use a different method of generation than 
  19.     VistaPro does.  VistaPro's fractal landscapes are intended to
  20.     mimic real landscapes but FRACTAL.EXE's are just "pictures" of
  21.     the three mathematical objects.
  22.  
  23.     FRACTAL.EXE uses the same type of graphical user interface as
  24.     VistaPro.  It also uses the same file requestor.  You can refer
  25.     to the VistaPro manual for general instructions on how menus,
  26.     buttons, and gadgets work.  FRACTAL.EXE requires a VGA graphics
  27.     card and a Microsoft compatible mouse.
  28.  
  29.     This document makes no attempt to explain what these fractals
  30.     are or the mathematics behind them.  You should be able to find
  31.     many books at your local bookstore which describe fractals and
  32.     iterated functions.
  33.  
  34.  
  35.     ------------------------------------------------------------------
  36.                 PROJECT MENU
  37.     ------------------------------------------------------------------
  38.  
  39.     Project --> Spawn DOS
  40.     ---------------------
  41.     This menu item allows you to start a DOS command line while
  42.     keeping FRACTAL.EXE in memory.  When you return to FRACTAL.EXE
  43.         all your settings will be intact.  This function allows you to
  44.     perform any DOS functions without quitting FRACTAL.EXE.  For
  45.     instance, you could format a new diskette for saving your
  46.     landscapes.  To exit from the DOS and return to FRACTAL.EXE you
  47.     should type EXIT at the DOS prompt.
  48.  
  49.     Project --> Save DEM
  50.     --------------------
  51.     This item saves the current landscape as a VistaPro DEM file. 
  52.     You will be allowed to select the directory and filename of the
  53.     file using the file requestor.
  54.  
  55.     Project --> Quit
  56.     ----------------
  57.     Select this item when you are done exploring and wish to quit the
  58.     program.
  59.  
  60.  
  61.     ------------------------------------------------------------------
  62.                 FRACTAL MENU
  63.     ------------------------------------------------------------------
  64.  
  65.     Fractal --> Lyapunov
  66.     --------------------
  67.     This item selects the Lyapunov type landscape.  It also resets
  68.     many the settings on the control panel to the defaults for this
  69.     type of landscape.
  70.  
  71.  
  72.     Fractal --> Mandelbrot
  73.     ----------------------
  74.     This item selects the Mandelbrot type landscape.  It also resets
  75.         many of the settings on the control panel to the defaults for this
  76.     type of landscape.
  77.  
  78.     Fractal --> Julia
  79.     -----------------
  80.     This item selects the Julia type landscape.  It also resets many
  81.         of the settings on the control panel to the defaults for this type
  82.     of landscape.
  83.  
  84.  
  85.     ------------------------------------------------------------------
  86.                 HEIGHT MENU
  87.     ------------------------------------------------------------------
  88.  
  89.     Height --> Linear
  90.     -----------------
  91.     This menu item selects linear heights in the landscape. 
  92.     Calculated values are used exactly as is in the landscape.  For
  93.     example, a mandelbrot escape time of 10 becomes 10 meters, 20
  94.     becomes 20 meters etc.
  95.  
  96.     Height --> Sqrt
  97.     ---------------
  98.     This menu item selects square root heights in the landscape.  The
  99.     sqare root of calculated values are used in the landscape.  For
  100.     example, a mandelbrot escape time of 9 becomes 3 meters, 16
  101.     becomes 4 meters etc.  Use this altitude type if you want to
  102.     compress a wide range of altitudes into a smaller range.
  103.  
  104.     Height --> Log
  105.     --------------
  106.     This menu item selects logrithmic heights in the landscape.  The
  107.     log (base 10) of calculated values are used in the landscape.  For
  108.     example, a mandelbrot escape time of 10 becomes 1 meter, 100
  109.     becomes 2 meters etc.  Use this altitude type if you want to
  110.     compress a very wide range of altitudes into a smaller range.
  111.  
  112.  
  113.     ------------------------------------------------------------------
  114.                 CONTROL PANEL
  115.     ------------------------------------------------------------------
  116.  
  117.     Lyapunov Control String
  118.     -----------------------
  119.     This is the control string which determines which of the two
  120.     lyapunov equations is executed for each iteration.  Only the
  121.     least sinificant bit of each character is acually used so the
  122.     letter "a" is the same as the letter "c" is the same as the
  123.     letter "e" etc.... and "b" = "d" = "f" etc....  All you really
  124.     need to know is that changing this character string will change
  125.     the landscape -- different control strings will lead to different
  126.     landscapes.  We allow you to use all letters of the alphabet so
  127.     you can generate landscapes based on your name or any text that
  128.     you want.  This string is only used in the generation of lyapunov
  129.     landscapes.
  130.  
  131.     Start X
  132.     -------
  133.     The topographic map area is a window onto the two dimesional
  134.     mathmatical plane.  Start X is the coordinate of the horizontal
  135.     coordinate of the left edge of the topographic window.  You can
  136.     reposition the window by typing a new value into this gadget.
  137.     Gererally, all the intersting parts of all three fractal types
  138.     fall within the range of -2 to +2 on both the X and Y axis.
  139.  
  140.     Start Y
  141.     -------
  142.     The topographic map area is a window onto the two dimesional
  143.     mathmatical plane.  Start Y is the coordinate of the vertical
  144.     coordinate of the bottom edge of the topographic window.  You can
  145.     reposition the window by typing a new value into this gadget.
  146.     Gererally, all the intersting parts of all three fractal types
  147.     fall within the range of -2 to +2 on both the X and Y axis.
  148.  
  149.     Size
  150.     ----
  151.     This value controls the range (on the X and Y axis) that the
  152.     topographic window covers.  For example, a value of 2.0 means
  153.     that the window will cover a range of 2.0 accross the X and Y
  154.     axis of the topographic map.  If the Start X value is 1.0 then
  155.     the window will cover the range from 1.0 to 3.0 on the horizontal
  156.     axis.
  157.  
  158.     Julia X
  159.     -------
  160.     This represents the coordinate on the Mandelbrot set for which
  161.     the gernerated Julia set is based.  This is the "real" part of
  162.     the coordinate.  As with the Start X value, most of the
  163.     interesting values will range from -2 to +2.  This value is only
  164.     used in generating Julia landscapes.
  165.  
  166.     Julia Y
  167.     -------
  168.     This represents the coordinate on the Mandelbrot set for which
  169.     the gernerated Julia set is based.  This is the "imaginary" part
  170.     of the coordinate.  As with the Start Y value, most of the
  171.     interesting values will range from -2 to +2.  This value is only
  172.     used in generating Julia landscapes.
  173.  
  174.     Seed
  175.     ----
  176.     This is starting value used to generate Lyapunov landscapes.  It
  177.     should be set between 0 and 1.  It's value becomes less and less
  178.     critical as the interation count is raised.
  179.  
  180.     Iteratns
  181.     --------
  182.     This controls the maximum number of iterations allowed before
  183.     "timing out" on calculations of all three objects.  The larger
  184.     you make this value the longer calculations will take -- but
  185.     larger values will also bring out additional detail.
  186.  
  187.     VScale
  188.     ------
  189.     This controls the vertical scale of the landscape.  Large values
  190.     will result in landscapes with tall features, smaller values will
  191.     result in flatter landscapes.  This setting is used for all three
  192.     fractal types.  "Good" values range from 1000 to 5000 but you are
  193.     free to enter small or larger values.
  194.  
  195.     Zoom Var
  196.     --------
  197.     This is the variable zoom function.  It allows you to zoom into
  198.     or out of a section of the fractal object.  After selecting the
  199.     button you must mark a box on the topomap to zoom in to.  Use the
  200.     mouse (position and click the left mouse button) to select both
  201.     corners of the area of interest.  If you mark an area smaller
  202.     than the topographic map you will zoom in to that area.  If you
  203.     mark an area larger than the topographic area you will zoom out
  204.     to that area.  Zooming in or out changes the Start X, Start Y,
  205.     and Size variables. Generation of the new area will start
  206.     automatically.
  207.  
  208.     Zoom +2x
  209.     --------
  210.     This button allows you to zoom in two fold onto the fractal
  211.     object.  After selecting the button you must select the area to
  212.     zoom into by moving the visible box over the area of interest and
  213.     pressing the left mouse button.  Zooming in or out changes the
  214.     Start X, Start Y, and Size variables.  Generation of the new area
  215.     will start automatically.
  216.  
  217.     Zoom -2x
  218.     --------
  219.     This button allows you to zoom out two fold onto the fractal
  220.     object.  You have no further choise of area, the window is simply
  221.     expanded two fold around the current center of the topographic
  222.     window. Zooming in or out changes the Start X, Start Y, and Size
  223.     variables.  Generation of the new area will start automatically.
  224.  
  225.     Generate
  226.     --------
  227.     This initiates the generation of a new fractal landscape using
  228.     the current settings.  Generation is not automatic when you
  229.     change some of the settings since it is assumed that you might
  230.     also want to change some of the other settings.  In these cases
  231.     you will need to use the Generate button to start calculating a
  232.     new landscape.
  233.  
  234.     Escape
  235.     ------
  236.     You can press the escape key to terminate the generation of the
  237.     current landscape.  When the program is done with the current
  238.     horizontal line it will stop calculating and you will be able
  239.     to change other settings or quit.
  240.  
  241.  
  242.